'\" t
.\"     Title: IPSEC_STRERROR
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 02/25/2010
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "IPSEC_STRERROR" "3" "02/25/2010" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
_ipsec_strerror \- error messages for the IPsec policy manipulation library
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <netinet6/ipsec\&.h>
.fi
.ft
.HP \w'const\ char\ *ipsec_strerror('u
.BI "const char *ipsec_strerror(void);"
.SH "DESCRIPTION"
.PP
#include <netinet6/ipsec\&.h> declares
.PP
extern int ipsec_errcode;
.PP
which is used to pass an error code from IPsec policy manipulation library to a user program\&. The ipsec_strerror(); function can be used to obtain the error message string for the error code\&.
.PP
The array pointed to is not to be modified by the program\&. Since ipsec_strerror(); uses
\fBstrerror\fR(3)
as an underlying function, calling
\fBstrerror\fR(3)
after ipsec_strerror(); would overwrite the the return value from ipsec_strerror(); and make it invalid\&.
.SH "RETURN VALUES"
.PP
The ipsec_strerror(); function always returns a pointer to C string\&. The C string must not be overwritten by the caller\&.
.SH "SEE ALSO"
.PP
\fBipsec_set_policy\fR(3)
.SH "HISTORY"
.PP
The ipsec_strerror(); function first appeared in WIDE/KAME IPv6 protocol stack kit\&.
.SH "BUGS"
.PP
The ipsec_strerror(); function will return its result which may be overwritten by subsequent calls\&.
.PP
\fIipsec_errcode\fR
is not thread safe\&.
